{{tag>Jaunty internet BROUILLON}}

----

====== Extensions pour Mediawiki ======

Les extensions sont des ajouts à l'installation de base de [[Mediawiki]] qui permettent d'en améliorer le fonctionnement, ajouter des tags ou des fonctionnalités.

Aucune de ces extensions n'est propre à Ubuntu

Les extensions décrites ci-dessous on été testées sous Ubuntu 9.04 selon les requis de Mediawiki.

<note important>
Toutes les extensions demandent une modification de « /var/www/mediawiki/LocalSettings.php » : n'oubliez donc pas de faire une sauvegarde préalable à toute modification de ce fichier.
</note>

===== Installation des extensions déjà pacagées =====

  * Avoir installé [[mediawiki]]
  * Installer le paquet : **[[apt>mediawiki-extensions]]**

===== PDFexport =====

==== Définition ====

  * Date du test de l'extension: juillet 2009
  * Page officielle (en) [[http://http://www.mediawiki.org/wiki/Extension:Pdf_Export|pdfExport]]
  * PdfExport est une extension de MediaWiki particulièrement intéressante: elle permet de demander la traduction de l'article en format PDF. Dans le menu principal apparait alors dans le menu de gauche "Imprimer en PDF"


==== Installation ====

  - En mode superuser créer le répertoire **/var/www/mediawiki/extensions/PdfExport**.
  - Pour chacun des 4 fichiers ci-dessous :
    * récupérer le code 
    * créer le fichier ennoncé
    * le placer dans /var/www/mediawiki/extensions/PdfExport
    - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.php|PdfExport.php]]
    - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport_body.php|PdfExport_body.php]]
    - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.i18n.php|PdfExport.i18n.php]]
    - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.i18n.alias.php|PdfExport.i18n.alias.php]]
  - Dans le fichier /var/www/mediawiki/LocalSettings.php  et **avant la ligne** de demande de rafraichissement du cache<code>
$wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) );
</code>**ajouter la ligne**<code>
require_once("extensions/PdfExport/PdfExport.php");
</code>
  - Cette extension demande  une modification des droits d'accès de /var/www/mediawiki/images/tmp pour que cette extension  puisse créer et effacer le fichier temporaire 
<note important>manque d'information pour la modification des droits</note>

==== Utilisation ==== 

Dans le menu principal apparait alors dans le menu de gauche "Imprimer en PDF"

APERÇU :

{{:pdfexport.jpg}}

==== Particularités rencontrées ==== 

  - "Imprimer en PDF" n'apparait que dans certains skin de MediaWiki
  -  lors des tests certaines erreurs d'affichage des quotes sont survenues dans l'export en PDF sans affecter le contenu du PDF


===== CITE (références /notes de bas de page) =====

==== Définition ====

  * Date du test de l'extension: aout  2009
  * Page officielle (en) [[http://www.mediawiki.org/wiki/Extension:Cite/Cite.php|Cite]]
  * CITE est une extension particulièrement utile pour les personnes qui souhaitent référencer ou citer leur sources par des notes de bas de page  . 

==== Pré-requis ====

aucun

==== Installation ====

**Récupérer les fichiers** [[http://www.mediawiki.org/wiki/Special:ExtensionDistributor/Cite|situés ici]]
(j'ai pris la version "trunk" = version en cours de développement)

**copier le répertoire** contenu dans l'archive dans le répertoire /var/www/mediawiki/extensions


**Ajouter la ligne**
dans le fichier /var/www/mediawiki/LocalSettings.php

<code>
require_once('extensions/Cite/Cite.php');
</code>

avant la ligne

<code>
$wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) );
</code>

==== Utilisation ====

placer vos références entre les tags %%<ref>%% et %%</ref>%%

exemple:
  <ref>ceci est une référence unique </ref> 

à la fin de votre article placer simplement la balise
  <references/>

Quand vous citez plusieurs fois la même source, il est particulièrement intéressant de les citer dans un même groupe entre les balises 

  <ref name="nom_de_la_reference">et </ref>

chaque fois que vous souhaiterez faire appel à ce groupe il vous suffira de faire appel à la balise <ref name="nom_de_la_reference">

exemple:

<code>
Lorem ipsum dolor sit amet,<ref name="groupe1">Souvenez-vous que c'est le texte de la première référence à l'appel du groupe qui est affichée.</ref>

Suspendisse gravida ante a felis.<ref name="groupe1">ce texte est complètement superflu, vous 
ne le verrez apparaitre nulle part, c'est la première référence du groupe qui sera affichée vous pouvez tout aussi bien laisser en blanc</ref>
</code>

<note tip>Vous ne devez pas prévoir la numérotation de vos notes de bas de page : les effets du code sont automatiques et immédiat et la numérotation reste cohérente à chaque mise à jour de votre article</note>


===Illustration : code ===

{{tutoriel:tutoriel:mediawiki_reference.jpg}}

=== Illustration : effet du code ===

{{tutoriel:tutoriel:mediawiki_reference_affichage.jpeg}}

===  Illustration : apparition en bas de page ===

{{tutoriel:tutoriel:mediawiki_reference_resultats.jpeg}}


==== Particularités rencontrées ==== 

aucune

===== Voir aussi =====

  * La liste exhaustive des extensions et de leur installation se trouve sur le [[http://www.mediawiki.org|site de MediaWiki]].
----

//Contributeur principal : [[:utilisateurs:phira]].//